de.cebis.moccabox.util
Class AttributeStore

java.lang.Object
  extended by de.cebis.moccabox.util.AttributeStore
All Implemented Interfaces:
java.io.Serializable

public class AttributeStore
extends java.lang.Object
implements java.io.Serializable

Klasse, die der Verwaltung von Attributes dient. Sie stellt Methoden zum Speichern von Attributen und des Zugriffs darauf zur Verfügung. Wird vor allem genutzt, um interne Speicher von Vorgangsobjekten und Kontexten abzubilden. Die Namen der verwalteten Attribute sind nicht zwingend eineindeutig. D.h. es kann mehrere Attribute mit gleichem Attributsausprägung Namen geben.

Author:
weichelt - 17.01.2005
See Also:
Serialized Form

Constructor Summary
AttributeStore()
          Parameterloser Konstruktor zum Erzeugen eines neuen AttributeStore.
AttributeStore(java.util.Collection<Attribute> collection)
          Konstruktor zum Erzeugen eines neuen AttributeStore.
 
Method Summary
 void addAttribute(Attribute attribute)
          Fügt der Liste der Attribute für diesen Kontext ein weiteres Attribute hinzu.
 void addAttribute(java.lang.String name, java.lang.Object value)
          Hinzufügen eines weiteren Attributes.
 void addAttributes(Attribute[] attributes)
          Fügt der Liste der Attribute für diesen Kontext eine Menge neuer Attribute hinzu.
 void clearAttributes()
          Löscht alle vorhandenen Attribute des Kontextes.
 boolean containsAttribute(java.lang.String name)
          Liefert zurück, ob das Kommando das Attribut mit einem bestimmten Name enthält oder nicht.
 Attribute getAttribute(java.lang.String name)
          Gibt das erste Attribut zurück, das einen bestimmten Namen hat.
 Attribute[] getAttributes()
          Gibt alle Attribute des Kontextes zurück.
 Attribute[] getAttributesByName(java.lang.String name)
          Gibt die Attribute zurück, die einen bestimmten Namen haben.
 Attribute[] getAttributesByPattern(java.lang.String pattern)
          Gibt die Attribute zurück, die einen bestimmten Namen beinhalten.
 Attribute[] getAttributesStartingWith(java.lang.String pattern)
          Gibt die Attribute zurück, die einen bestimmten Namen beinhalten.
 java.lang.Object getAttributeValue(java.lang.String name)
          Gibt den Wert des ersten Attributs zurück, das einen bestimmten Namen hat.
 java.lang.Object getAttributeValue(java.lang.String name, java.lang.Class expected)
          Gibt den Wert des ersten Attributs zurück, das einen bestimmten Namen hat.
 java.lang.Object getAttributeValue(java.lang.String name, java.lang.Class expected, java.lang.Object alternativeValue)
          Gibt den Wert des ersten Attributs zurück, das einen bestimmten Namen hat.
 java.lang.Object[] getAttributeValues(java.lang.String name)
          Zurückgeben der Werte aller Attribute, die einen bestimmten Namen haben.
 void removeAttribute(java.lang.String name)
          Entfernt alle Attribute mit einem bestimmten Namen.
 void setAttribute(Attribute attribute)
          Fügt ein TaskAttribute der Liste hinzu.
 java.lang.String toString()
          Umwandeln und zurückliefern aller Attributes des AttributeStore in einer komma-separierten Liste.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

AttributeStore

public AttributeStore()
Parameterloser Konstruktor zum Erzeugen eines neuen AttributeStore.


AttributeStore

public AttributeStore(java.util.Collection<Attribute> collection)
Konstruktor zum Erzeugen eines neuen AttributeStore.

Parameters:
collection - Sammlung der Attribute-Objekte, die im AttributeStore gespeichert werden sollen.
Method Detail

setAttribute

public void setAttribute(Attribute attribute)
Fügt ein TaskAttribute der Liste hinzu. Sofern ein Attribut gleichen Namens schon vorhanden ist, wird es durch das angegebene ersetzt. Andernfalls wird das Attribut einfach hinzugefügt.

Parameters:
attribute - Das hinzuzufügende Attribute.

addAttribute

public void addAttribute(Attribute attribute)
Fügt der Liste der Attribute für diesen Kontext ein weiteres Attribute hinzu. Auch wenn es bereits ein gleichnamiges Attribut gibt, wird dieses zusätzlich hinzugefügt.

Parameters:
attribute - Das hinzuzufügende Attribute.

addAttributes

public void addAttributes(Attribute[] attributes)
Fügt der Liste der Attribute für diesen Kontext eine Menge neuer Attribute hinzu.

Parameters:
attributes - Die hinzuzufügenden Attributes.

clearAttributes

public void clearAttributes()
Löscht alle vorhandenen Attribute des Kontextes.


removeAttribute

public void removeAttribute(java.lang.String name)
Entfernt alle Attribute mit einem bestimmten Namen.

Parameters:
name - Name der Attribute, die entfernt werden sollen. Existiert kein Attribut mit diesem Namen, wird keine Änderung auf dem AttributeStore vorgenommen.

getAttributes

public Attribute[] getAttributes()
Gibt alle Attribute des Kontextes zurück. Sind keine Attribute vorhanden, wird null zurückgeliefert.

Returns:
Liste der Attribute. Falls nicht vorhanden, null.

getAttributesByName

public Attribute[] getAttributesByName(java.lang.String name)
Gibt die Attribute zurück, die einen bestimmten Namen haben. Gibt es kein Attribut mit dem angegebenen Namen, wird null zurückgeliefert.

Parameters:
name - Name der Attribte, die zurückgeliefert werden sollen.
Returns:
Liste der Attribute, die den übergebenen Namen haben. Null, falls kein Attribut mit diesem Namen registriert ist.

containsAttribute

public boolean containsAttribute(java.lang.String name)
Liefert zurück, ob das Kommando das Attribut mit einem bestimmten Name enthält oder nicht.

Parameters:
name - Name des Attributes, das geprüft werden soll.
Returns:
True, falls vorhanden. False, andernfalls.

getAttributesStartingWith

public Attribute[] getAttributesStartingWith(java.lang.String pattern)
Gibt die Attribute zurück, die einen bestimmten Namen beinhalten. Gibt es kein Attribut mit dem angegebenen Namen, wird null zurückgeliefert.

Parameters:
pattern - Namensteil, mit dem das Attribut beginnen soll.
Returns:
Liste der Attribute, deren Namen mit dem übergebenen Namensteil beginnen. Null, falls keines der registrierten Attribute mit dem Namensteil beginnt.

getAttributesByPattern

public Attribute[] getAttributesByPattern(java.lang.String pattern)
Gibt die Attribute zurück, die einen bestimmten Namen beinhalten. Gibt es kein Attribut mit dem angegebenen Namen, wird null zurückgeliefert.

Parameters:
pattern - Namensteil, der im Namen des Attributes vorkommen soll.
Returns:
Liste der Attribute, deren Namen den übergebenen Namensteil enthält. Null, falls keines der registrierten Attribute den Namensteil enthält.

getAttribute

public Attribute getAttribute(java.lang.String name)
Gibt das erste Attribut zurück, das einen bestimmten Namen hat. Gibt es kein Attribut mit dem angegebenen Namen, wird null zurückgeliefert.

Parameters:
name - Name des gesuchten Attributes.
Returns:
Das Attribut mit dem gesuchten Namen. Existiert kein Attribut mit diesem Namen, wird Null zurückgeliefert.

getAttributeValue

public java.lang.Object getAttributeValue(java.lang.String name)
Gibt den Wert des ersten Attributs zurück, das einen bestimmten Namen hat. Gibt es kein Attribut mit dem angegebenen Namen, wird null zurückgeliefert.

Parameters:
name - Name des gesuchten Attributes.
Returns:
Der Wert des Attributs mit dem gesuchten Namen. Existiert kein Attribut mit diesem Namen, wird Null zurückgeliefert.

getAttributeValues

public java.lang.Object[] getAttributeValues(java.lang.String name)
Zurückgeben der Werte aller Attribute, die einen bestimmten Namen haben.

Parameters:
name - Name der gesuchten Attribute.
Returns:
Liste der Werte aller Attribute, die den entsprechenden Namen haben. Existiert kein Attribut mit diesem Namen, wird Null zurückgeliefert.

getAttributeValue

public java.lang.Object getAttributeValue(java.lang.String name,
                                          java.lang.Class expected)
Gibt den Wert des ersten Attributs zurück, das einen bestimmten Namen hat. Gibt es kein Attribut mit dem angegebenen Namen, wird null zurückgeliefert.

Parameters:
name - Name des gesuchten Attributes.
expected - Klasse des Wertes, der erwartet wird.
Returns:
Der Wert des Attributs mit dem gesuchten Namen konvertiert in die gesuchte Klasse. Existiert kein Attribut mit diesem Namen, wird Null zurückgeliefert.

getAttributeValue

public java.lang.Object getAttributeValue(java.lang.String name,
                                          java.lang.Class expected,
                                          java.lang.Object alternativeValue)
Gibt den Wert des ersten Attributs zurück, das einen bestimmten Namen hat. Gibt es kein Attribut mit dem angegebenen Namen, wird null zurückgeliefert.

Parameters:
name - Name des gesuchten Attributes.
expected - Klasse des Wertes, der erwartet wird.
alternativeValue - Alternativer Wert, falls der erwartete Wert nicht zurückgeliefert werden kann.
Returns:
Der Wert des Attributs mit dem gesuchten Namen konvertiert in die gesuchte Klasse. Existiert kein Attribut mit diesem Namen oder der tatsächliche Wert kann nicht konvertiert werden, wird der alternative Wert zurückgeliefert.

addAttribute

public void addAttribute(java.lang.String name,
                         java.lang.Object value)
Hinzufügen eines weiteren Attributes.

Parameters:
name - Name des hinzuzufügenden Attributes.
value - Wert des hinzuzufügenden Attributes.

toString

public java.lang.String toString()
Umwandeln und zurückliefern aller Attributes des AttributeStore in einer komma-separierten Liste.

Overrides:
toString in class java.lang.Object
Returns:
Liste des Inhalts des AttributeStore.